home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / tjgold.zip / INSTALL.004 / FGUSER02.TXT < prev    next >
Text File  |  1995-05-29  |  8KB  |  179 lines
  1.                                Installing Gold
  2.  
  3.                                     "Blow you bugles over the rich dead!
  4.                                      There's none of these so lonely and
  5.                                      poor of old But, dying, has made us
  6.                                      rarer than gold"
  7.                                       Rupert Brooks, The Dead, 1887-1915
  8.  
  9.  
  10. Installing the Toolkit
  11.  
  12.           This chapter describes how to install Gold and how to
  13.      configure the compiler to make the best use of Gold. Note that Gold
  14.      is available in a variety of disk formats. Regardless of the
  15.      density or number of diskettes, the installation process is the
  16.      same.
  17.  
  18. The Installation Files
  19.  
  20.      Each registered copy of Gold includes the following files:
  21.  
  22.           INSTALL.EXE    The main install program
  23.           INSTALL.INI    Initialization file used by the install program
  24.           INSTALL.001    GOLD source code, part 1
  25.           INSTALL.002    GOLD source code, part 2
  26.           INSTALL.003    Demo programs
  27.           INSTALL.004    ASCII Documentation
  28.           INSTALL.005    On-Line Help
  29.           GOLDREAD.ME    Tips, hints and last minute notes
  30.  
  31.           Diskette 1 includes the entire installation program along with
  32.      its associated .INI file. The installation program must be used to
  33.      automatically install the Gold onto a local drive. During the
  34.      installation, you will be prompted to select which components you
  35.      want installed, as well as the target directories where the files
  36.      will be placed. Install will not modify your AUTOEXEC.BAT or
  37.      CONFIG.SYS files.
  38.  
  39.           The installation program was written using Gold!
  40.  
  41. Using the Install Program
  42.  
  43.           At the DOS prompt, type A:INSTALL (or whichever drive/path
  44.      contains the INSTALL executable) and press Enter. A welcome dialog
  45.      is displayed. Select the OK button to proceeed, or Cancel to abort
  46.      the installation.
  47.  
  48.           Continuing presents you with the OPTIONS screen which allows
  49.      you to select individual installation options (see figure 2.1
  50.      below). You may tab between fields or use a mouse to move from
  51.      field to field.
  52.  
  53. Installation  Options
  54.  
  55.           The default destination drive has been set to drive C. With
  56.      the destination drive field active, you may alter this by pressing
  57.      the down cursor key or clicking on the down arrow. A list of
  58.      available drives is displayed. Use the up and down cursor keys to
  59.      highlight the appropriate drive and press enter or double click on
  60.      a drive.
  61.  
  62.           The available space for this drive will be determined and
  63.      updated in the appropriate field on screen.
  64.  
  65.           Selecting a floppy drive or a CDROM drive will return the
  66.      available space equal to -1. This indicates that the drive cannot
  67.      be written to.
  68.  
  69.           The options check box fields permit you to select which
  70.      elements of Gold will be installed. The four sections are:
  71.  
  72.           Source Code
  73.           Demonstration programs
  74.           Documentation in ASCII form
  75.           Custom On-Line help
  76.  
  77.           Each time an item's selection state is changed, the required
  78.      space field is updated to indicate how much space will be needed to
  79.      install all the options you have selected. Be sure you have enough
  80.      space for the selected options.
  81.  
  82.           At this point you may abort the installation by selecting the
  83.      abort button or you may select the Next button to continue to the
  84.      Destination screen (see figure 2.2. below).
  85.  
  86.  
  87. Destination Options
  88.  
  89.           If you modify any part of the source code subdirectory prior
  90.      to leaving the field, each optional subdirectory will reflect the
  91.      same changes. This behavious only occurs the first time you leave
  92.      the field. Don't worry if the subdirectories don't currently exist
  93.      on your hard drive, as the installation program will create them
  94.      for you.
  95.  
  96.           If you have a change of heart here you may return to the
  97.      Options screen and make modifications before proceeding by
  98.      selecting the Prev button.
  99.  
  100.           When you are satisfied with all the options and destinations
  101.      you have chosen, select the Install button and the installation
  102.      program will do the rest.
  103.  
  104.           The progress of the installation is displayed for you during
  105.      the remainder of the installation.
  106.  
  107.           Finally, the GOLDREAD.ME file is presented to keep you
  108.      informed of all the last minute notes and some tips that we have
  109.      learned along the way.
  110.  
  111.      That's it. Installation complete!
  112.  
  113. Installing the On-Line Help
  114.  
  115.           The On-Line Help provided with Gold is a compiled help file
  116.      designed specifically to be integrated with Borland Pascal version
  117.      7. After being properly installed, Gold's on-line help operates as
  118.      a part of the IDE help system.
  119.  
  120.           Move the compiled help file, TTTGOLD.TPH, to the directory in
  121.           which BP.EXE is located (typically \BP\BIN).
  122.  
  123.           Run Borland Pascal and select the Help menu. Select FILES...
  124.           from this menu. From the file selection dialog which has now
  125.           appeared, select TTTGOLD.TPH and press OK.
  126.  
  127.           Your specific configuration may effect your ability to load
  128.      and use TTTGOLD.TPH. The GOLD On-line Help contains extensive
  129.      information on over 700 Pascal routines designed to speed up your
  130.      development time. As you attempt to install TTTGOLD.TPH, you may
  131.      receive a message indicating that the help index is too large. To
  132.      resolve this, return to the HELP, FILES... dialog and deselect some
  133.      of the help files that you may not need. Borland has included
  134.      several help features that you may not use on a regular basis.
  135.  
  136.           Be sure to save these options so that the help file will load
  137.      each time you use the environment.
  138.  
  139. Configuring the Compiler
  140.  
  141.           To successfully develop applications with Gold you need to
  142.      ensure that overflow checking is disabled, and that complete
  143.      boolean evaluation is disabled. These options can be set from the
  144.      Compiler Options menu, or by using the {$Q-} and {$B-} directives,
  145.      respectively.
  146.  
  147.           Gold stores all the compiler switches in the include file
  148.      GOLDFLAGS.INC. This file should be included in all your
  149.      applications and units. (See the next chapter for further
  150.      discussion of compiler directives).
  151.  
  152. Running the Demos
  153.  
  154.           Each demo program is designed to demonstrate a specific aspect
  155.      of using Gold. They are designed to educate the developer, not to
  156.      show off! Each unit has its own set of demos and each is named
  157.      accordingly with this in mind.
  158.  
  159.           If you encounter problems during the development of your
  160.      application, you may find that your best source of information is
  161.      the demo programs, where you can see the particular routine in
  162.      action.
  163.  
  164.           DEMOVIEW.PAS helps you to quickly browse the demo file names
  165.      while displaying the demo description. You may optionally view the
  166.      source code of the selected demo.
  167.  
  168.           Another demo, DEMRD8.PAS, provides a means of previewing and
  169.      selecting color combinations for your applications and returns the
  170.      color number that may be used in the toolkit routines.
  171.  
  172.           DEMWIN2.PAS is an excellent program that allows you to preview
  173.      all the window styles and border combinations to predetermine what
  174.      might be included in your programs.
  175.  
  176.           Take the time to run all the demos. I guarantee you'll learn
  177.      something.
  178.  
  179.